---
title: Microsoft Excel
description: 读取、写入和更新数据
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="microsoft_excel"
  color="#E0E0E0"
  icon={true}
  iconSvg={`<svg className="block-icon"
      
      xmlns='http://www.w3.org/2000/svg'
      version='1.1'
      id='Livello_1'
      x='0px'
      y='0px'
      viewBox='0 0 2289.75 2130'
      enableBackground='new 0 0 2289.75 2130'
    >
      <path
        fill='#185C37'
        d='M1437.75,1011.75L532.5,852v1180.393c0,53.907,43.7,97.607,97.607,97.607l0,0h1562.036  c53.907,0,97.607-43.7,97.607-97.607l0,0V1597.5L1437.75,1011.75z'
      />
      <path
        fill='#21A366'
        d='M1437.75,0H630.107C576.2,0,532.5,43.7,532.5,97.607c0,0,0,0,0,0V532.5l905.25,532.5L1917,1224.75  L2289.75,1065V532.5L1437.75,0z'
      />
      <path fill='#107C41' d='M532.5,532.5h905.25V1065H532.5V532.5z' />
      <path
        opacity='0.1'
        enableBackground='new'
        d='M1180.393,426H532.5v1331.25h647.893c53.834-0.175,97.432-43.773,97.607-97.607  V523.607C1277.825,469.773,1234.227,426.175,1180.393,426z'
      />
      <path
        opacity='0.2'
        enableBackground='new'
        d='M1127.143,479.25H532.5V1810.5h594.643  c53.834-0.175,97.432-43.773,97.607-97.607V576.857C1224.575,523.023,1180.977,479.425,1127.143,479.25z'
      />
      <path
        opacity='0.2'
        enableBackground='new'
        d='M1127.143,479.25H532.5V1704h594.643c53.834-0.175,97.432-43.773,97.607-97.607  V576.857C1224.575,523.023,1180.977,479.425,1127.143,479.25z'
      />
      <path
        opacity='0.2'
        enableBackground='new'
        d='M1073.893,479.25H532.5V1704h541.393c53.834-0.175,97.432-43.773,97.607-97.607  V576.857C1171.325,523.023,1127.727,479.425,1073.893,479.25z'
      />
      <linearGradient
        id='SVGID_1_'
        gradientUnits='userSpaceOnUse'
        x1='203.5132'
        y1='1729.0183'
        x2='967.9868'
        y2='404.9817'
        gradientTransform='matrix(1 0 0 -1 0 2132)'
      >
        <stop offset='0' style={{ stopColor: '#18884F' }} />
        <stop offset='0.5' style={{ stopColor: '#117E43' }} />
        <stop offset='1' style={{ stopColor: '#0B6631' }} />
      </linearGradient>
      <path
        fill='url(#SVGID_1_)'
        d='M97.607,479.25h976.285c53.907,0,97.607,43.7,97.607,97.607v976.285  c0,53.907-43.7,97.607-97.607,97.607H97.607C43.7,1650.75,0,1607.05,0,1553.143V576.857C0,522.95,43.7,479.25,97.607,479.25z'
      />
      <path
        fill='#FFFFFF'
        d='M302.3,1382.264l205.332-318.169L319.5,747.683h151.336l102.666,202.35  c9.479,19.223,15.975,33.494,19.49,42.919h1.331c6.745-15.336,13.845-30.228,21.3-44.677L725.371,747.79h138.929l-192.925,314.548  L869.2,1382.263H721.378L602.79,1160.158c-5.586-9.45-10.326-19.376-14.164-29.66h-1.757c-3.474,10.075-8.083,19.722-13.739,28.755  l-122.102,223.011H302.3z'
      />
      <path
        fill='#33C481'
        d='M2192.143,0H1437.75v532.5h852V97.607C2289.75,43.7,2246.05,0,2192.143,0L2192.143,0z'
      />
      <path fill='#107C41' d='M1437.75,1065h852v532.5h-852V1065z' />
    </svg>`}
/>

{/* MANUAL-CONTENT-START:intro */}
[Microsoft Teams](https://www.microsoft.com/en-us/microsoft-365/excel) 是一款功能强大的电子表格应用程序，可实现数据管理、分析和可视化。通过 Sim 中的 Microsoft Excel 集成，您可以以编程方式读取、写入和操作电子表格数据，以支持您的工作流自动化需求。

通过 Microsoft Excel 集成，您可以：

- **读取电子表格数据**：访问特定范围、工作表和单元格中的数据
- **写入和更新数据**：添加新数据或修改现有电子表格内容
- **管理表格**：创建和操作表格数据结构
- **处理多个工作表**：处理工作簿中的多个工作表
- **处理数据**：导入、导出和转换电子表格数据

在 Sim 中，Microsoft Excel 集成通过 OAuth 身份验证提供无缝的电子表格功能访问。您可以从特定范围读取数据，写入新信息，更新现有单元格，并处理各种数据格式。该集成支持读取和写入操作，具有灵活的输入和输出选项。这使您能够构建有效管理电子表格数据的工作流，无论是提取信息进行分析、自动更新记录，还是在应用程序之间保持数据一致性。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Microsoft Excel 集成到工作流程中。可以读取、写入、更新和添加到表格中。需要 OAuth。

## 工具

### `microsoft_excel_read`

从 Microsoft Excel 电子表格中读取数据

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | 是 | 要读取的电子表格的 ID |
| `range` | string | 否 | 要读取的单元格范围。接受 "SheetName!A1:B2" 形式的显式范围，或仅输入 "SheetName" 以读取该工作表的已用范围。如果省略，将读取第一个工作表的已用范围。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `data` | object | 电子表格中的范围数据 |

### `microsoft_excel_write`

向 Microsoft Excel 电子表格写入数据

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | 是 | 要写入的电子表格的 ID |
| `range` | string | 否 | 要写入的单元格范围 |
| `values` | array | 是 | 要写入电子表格的数据 |
| `valueInputOption` | string | 否 | 要写入数据的格式 |
| `includeValuesInResponse` | boolean | 否 | 是否在响应中包含写入的值 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `updatedRange` | string | 更新的范围 |
| `updatedRows` | number | 更新的行数 |
| `updatedColumns` | number | 更新的列数 |
| `updatedCells` | number | 更新的单元格数 |
| `metadata` | object | 电子表格元数据 |

### `microsoft_excel_table_add`

向 Microsoft Excel 表格添加新行

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `spreadsheetId` | string | 是 | 包含表格的电子表格的 ID |
| `tableName` | string | 是 | 要添加行的表格名称 |
| `values` | array | 是 | 要添加到表格的数据 \(数组的数组或对象的数组\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `index` | number | 添加的第一行的索引 |
| `values` | array | 添加到表格的行数组 |
| `metadata` | object | 电子表格元数据 |

## 注意

- 类别：`tools`
- 类型：`microsoft_excel`
